**CONFIDENTIAL**
Please keep in mind that you are bound by all terms of the Developer License Agreement, including non-disclosure.  Please refer to the Developer License Agreement for more information.

QuarkXPress 4.0 Preliminary Developer Kit
=========================================

QXP 4.0 Sample XTs

This folder contains: 
---------------------
* Sample XTensions that can be compiled with Microsoft Visual C 4.2.(We do not currently support Borland C++, but plan to do so in the future.)
* Instructions on how to use the Sample XTensions titled: "Sample XTs ReadMe." (You are reading this file now.)


Sample XTensions
================
Please see the initial comments in each source file for information about what that particular sample XTension does.

These samples are all built using the headers and libraries for QuarkXPress 4.0 beta.  They will not run with any previous versions of the application.  

The folder for a typical Sample XT contains the following files:
 * <project>.c -- A source file used by the project.
 * <project>.rc -- A resource file used by the project.
 * <project>.h -- A header file used by the source code.

The source file shows how you can write source code that automatically configures itself to the compiler currently in use.

Creating a project with Visual C++ 4.2
--------------------------------------
Currently we support the Visual C programming environment for the development of XTensions for QuarkXPress 4.0.  We plan on supporting the Borland programming environment in the future but don't currently do so.  Please complete the following steps in order to create an XTensions project.

1) Select File/New from the menu.
2) Select project workspace in order to create a new project and click on the OK button.
3) Select Dynamic Link Library as the type and check the Win32 checkbox.
4) Enter a project name and select the create button.
5) Select Insert/Files into Project from the menu.
6) Insert all files(*.c,*.rc,...) that are part of your XTension and insert XTEVCWIN.LIB.
7) Select Build/Settings from the menu.
8) Go to the C/C++ tab.
9) Select Code Generation from the Category combo box.
10) Select __stdcall for the calling convention combo box and click on the OK button.
11) You are now ready to build your XTension!

DISCLAIMER
-----------
All sample XTensions software provided by Quark, including the sample XTensions provided in this developer material, are provided as a means of demonstrating how to use the XTensions interface; they are not not intended, nor guaranteed to be bug-free or fully comprehensive in their treatment of the respective subject areas of XTensions development.

"Detective" Debugging Tools
-------------------------
The XTensions on this disk that have "Detective" as part of their name can be used as debugging tools. In general, once installed, they add a menu item to the View menu that displays a palette of information. As you move around a document, these palettes peek into the relevant data structures and show what they contain.

We provide the source code for these Detectives as further examples to you of writing WAPs in XTensions, and so that you can customize them further to display extra information relating to your own XTension if you want to. In particular, the Hidden Text Detective requires some customizing for maximum effectiveness.

